package com.example.forum.services;

import com.example.forum.model.Article;
import org.apache.ibatis.annotations.Param;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

public interface IArticleService {

    /**
     * 发布帖子
     *
     * @param article 要发布的帖子
     */
    @Transactional
    // 当前方法中的执行过程会被事务管理起来
    void create(Article article);

    /**
     * 查询所有帖子
     *
     * @return
     */
    List<Article> selectAll();

    /**
     * 根据板块id，查询对应板块的帖子
     *
     * @param boardId 板块Id
     * @return
     */
    List<Article> selectAllByBoardId(Long boardId);

    /**
     * 根据帖子 id 查询帖子详情
     * 关联了用户表和板块表，用于点开文章时，显示帖子的关联信息（作者，点赞数等）
     *
     * @param id 帖子 id
     * @return
     */
    Article selectDetailById(Long id);

    /**
     * 根据帖子Id查询对应的帖子
     * 这个是只查询帖子表，只看帖子本身的内容，没有和其他表关联
     *
     * @param id 帖子 id
     * @return
     */
    Article selectById(Long id);

    /**
     * 编辑帖子
     *
     * @param id      帖子 id
     * @param title   帖子标题
     * @param content 帖子内容
     */
    void modify(Long id, String title, String content);

    /**
     * 根据帖子id，点赞相应的帖子
     *
     * @param id 帖子 id
     */
    void thumbsById(Long id);


    /**
     * 根据 Id 删除帖子
     *
     * @param id 帖子 Id
     */
    @Transactional
    void deleteById(Long id);

    /**
     * 增加帖子的回复数
     * @param id 帖子 id
     */
    void addOneReplyCountById(Long id);
}
